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DECUS Program Library Write-up 


DECUS NO. 8-651 


50 L1Y1T ( SORT OVERLAY LISTINGS WITH IY1AG TAPE) 


General 


If a PAL—8 program has been built from a number of programs 
which overlay each other, S0LIT1T may be used to build a 
composite listing of the whole program, from the listings 
of the overlays. Input and output is on Dectape. 


An example of the use of SOLIYIT is given in Appendix 1. 


Description 

The program is divided into 5 parts. 

a) Initialization 

The operator specifies the input and output files: the 
input tape directory is examined, and the output file 
is opened. 

All file names have the subscript .LS 

b) Pass 1 


This is to check that the listings files specified 




























actually do correspond 
The listings are read, 
the program is checked 
reported. 


with the composite program, 
and then a binary paper tape of 
against them, with differences 


c) Pass 2 


The listings are read, and 
composite program, it is no 
data is obtained. (This is 
to the file into the corres 
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field 1.) 


d) Pass 3 


The listings are read, and any line containing "=" 
followed immediately by a "6” is output. (This is 
to give easy reference to special I/O instructions). 

e) Pass 4 


This is where most of the output occurs. Field 1 is 

read through, to find the appropriate file for each program 

address. The file is searched, and the appropriate 

line, together with proceeding lines of comment, are printed. 

Lines containing "=", and those starting with 

are ignored.lines containing form feed are ignored, and 

a form feed is inserted after every 55 lines. When 

field 1 has been read through the output file is closed, 

and the program halts. 
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All operator input messages are effective when CR is pressed. 
Before this, lines in error may be deleted by CTRI_/u. 

1. Load SO LITIT using PS8, Program halts at 0200 . Load 
DECTAPES. Press continue. 

2. message DTA? is output. Enter number of OTA containing 
input files. 


3. 


message DTA OUT? is output. Enter number of DTA to 
contain output file. 


4 . 


message 0/P FILE? is output. Enter name of output file. 

Do not include subscript. .LS will be added automatically. 


5. message HOUi IK1ANY? is output. 


Enter number of input files. 


6. message 1 FILE/LINE LEAST SIG FIRST is output. Enter 
the names of the input files, oldest first. Do not 
include subscript, .LS will be added automatically. 

7. message PAPER TAPE is output. Load program binary tape 
on high speed reader. Press any teletype key. A list 
of differences will be output on the teletype. (There 
u/ill always be one listed for the track sum). The 
program will halt. If satisfactory, press continue. 


8 . 


Program will run to 


end. 





















Special Features 


Some rather artificial features in the program are included 
for special local needs, and may easily be changed. Eg:- 

1. During pass 2, address lines are only output if "=" 
is followed by "6". 

2. During pass 2, lines are ignored. 

If it is not required to check the listings against paper 
tape, or if the tape is to be read on a teletype, this can 
be changed. As the program stands, to ignore reading paper 
tape wait for the message PAPER TAPE, then halt, load 
address 0'634 and continue. (Do not skip pass 1, as this 
also finds the ends' of the listings files). 

It would probably be easy to modify 50LIY1T to sort programs 
contained in more than 1 field, providing S0LIK1T has one more 
field available than the length of the program it is sorting. 

Limitations 

30LIYIT will not deal with the following conditions. 

1. If one of the source programs has any address used more 
than once. 
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e.g. 

*200 

TAD A 

*200 

TAD B 

Depending on various circumstances, either line may be output 
for address 0200 , rather than the second line. 


Run Time 

As a rough guide, a program made up of a main program 
occupying a complete field, with 14 overlays averaging about 6 
each, all with the normal amount of comment, takes about 
3 or 4 hours. 


Author: K.G. Jones 
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APPENDIX 1 


Example of Use of SOLIYIT 


Three programs are shown: MAIN is overlaid first by 
CORRECTION 1, then by CORRECTION 2. 
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This is the result of running SO LIYIT with those three 
programs as input. 

It is seen that for each program address, the line from 
the appropriate listing ha3 been output, together with 
any preceeding comments from the same listing. 

Note that the lines have been deleted. 
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